home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2001 January / MacHome Magazine Demo Disc January 2001.iso / mac / Software / Networking / HTML Rename!.sea / HTML Rename! / Readme-Rename.txt < prev    next >
Encoding:
Text File  |  2000-08-31  |  14.9 KB  |  334 lines  |  [TEXT/ttxt]
  1. HTML Rename!(TM) version 2.00
  2. Copyright (c) 1996-2000 Expandable Language
  3. All rights reserved
  4.  
  5.  
  6. WHAT DOES HTML RENAME! DO?
  7. --------------------------
  8. HTML Rename!(R) eliminates the problems encountered when moving files 
  9. between DOS/Windows, Macintosh, and UNIX file systems.  By changing file 
  10. names (case, length, and invalid characters) and fixing links in HTML 
  11. code, HTML Rename! ensures that your files and Web pages will work on 
  12. any operating system.  Using HTML Rename! before you transfer files (for 
  13. example, uploading a Web site to a UNIX server) saves you from needing 
  14. to repair mangled filenames, broken links, and extra or missing carriage 
  15. return characters in text files.
  16.  
  17. HTML Rename! assists Web site development by checking the consistency of 
  18. URL links and generating reports on local and external URLs.  It 
  19. guarantees that your site will work on any operating system by enforcing 
  20. a file naming convention. HTML Rename! can automatically change every 
  21. filename to fit a new naming convention, or you can choose to 
  22. individually alter each invalid filename as HTML Rename! reviews it. Run 
  23. HTML Rename! before each Web site upload and never have another broken 
  24. link! 
  25.  
  26.  
  27.  
  28. HTML RENAME!'S FEATURES
  29. -----------------------
  30. * Targets DOS, Macintosh, UNIX, and other filesystems -- including ISO 
  31.   9660 (the most universal naming structure on the planet)
  32. * Reports and renames files whose names are invalid on a target system
  33. * Automatically or interactively generates valid filenames
  34. * Updates links in your HTML pages for renamed files
  35. * Converts local links to relative or absolute URLs
  36. * Forces URL links to be case consistent with filenames
  37. * Alters file extensions such as HTML, JPEG, MPEG, & PING for the 
  38.   DOS/Windows, Macintosh, or UNIX convention (and fixes the names in the 
  39.   HTML code simultaneously)
  40. * Reports missing and external links
  41. * Removes files not referenced in a Web site (great for finding stray 
  42.   graphics and old files no longer in use)
  43. * Updates ASCII line ends for DOS/Windows, Macintosh, or UNIX format
  44. * Works on a single directory or an entire directory tree
  45. * Uses a clear, easy-to-follow, graphical wizard interface
  46.  
  47.  
  48. WHAT PROBLEMS DOES HTML RENAME! SOLVE?
  49. --------------------------------------
  50.  
  51. 1) Moving a Web Site to a Different System Can Break URL Links.
  52.  
  53. Typically, development of a Web site is done locally on a PC or 
  54. Macintosh and then uploaded to a server as the final "publishing" step.  
  55. If the server runs a different operating system than the local 
  56. development system, transferring the site to the server may break local 
  57. URL links.
  58.  
  59. One example of this is the strict filename upper and lower case 
  60. sensitivity in UNIX.  If you have an image file named "Janine.gif" and 
  61. reference that file as <a href "janine.gif"> the image will work when 
  62. testing on Macintosh or Windows.  On a UNIX server, however, you will 
  63. get a broken GIF because UNIX enforces stricter case sensitivity than 
  64. the Macintosh or Windows.  HTML Rename! fixes this by changing the URL 
  65. link to <a href "Janine.gif">, matching the filename exactly.
  66.  
  67. Other examples are characters which can appear in filenames on one 
  68. system but not on another.  For example, the filename "<Nov-96>.gif" is 
  69. valid on Macintosh and UNIX but not on Windows because of the greater-
  70. than and less than "<>" characters.  If you transfer a Web site 
  71. containing this file to an NT server, the links to this file will be 
  72. broken.
  73.  
  74. Yet another example is differing filename extensions.  For HTML, JPEG, 
  75. MPEG, and PING files; Macintosh and UNIX require the filename extensions 
  76. "html", "jpeg", "mpeg", and "ping"; while Windows requires "htm", "jpg", 
  77. "mpg", and "png".
  78.  
  79. HTML Rename! fixes all of the above problems, and more!
  80.  
  81.  
  82. 2) Verifying Your Web Site's URL Links
  83.  
  84. You can also use HTML Rename! to verify that your site is squeaky-clean 
  85. with no broken links.  HTML Rename! directly checks your local links and 
  86. generates a list of external URLs which you can check by loading the 
  87. list into your Web browser.  At the same time, HTML Rename! can verify 
  88. that no links will get broken in the process of uploading your Web site 
  89. to your server.
  90.  
  91.  
  92. 3) ISO 9660 Filenames for CD-ROMs
  93.  
  94. Many CD-ROM burning programs give you the option to automatically 
  95. convert filenames to ISO 9660 format, a specification which guarantees 
  96. all operating systems will understand the filenames.  HTML Rename! gives 
  97. you a finer granularity of control, allowing you to generate a report of 
  98. needed changes without renaming files, or to interactively rename files, 
  99. providing names which make more sense for your documents/data.
  100.  
  101.  
  102. 4) Removes Orphan Files
  103.  
  104. Web site development involves adjustments: graphics are modified and 
  105. discarded, a file is saved aside while testing new text or a new layout, 
  106. etc.  After a while, your site is littered with "orphans"--files that 
  107. are no longer used in the web site.  HTML Rename! can identify and 
  108. remove these orphan files, making your local directory clean so that 
  109. you can upload everything without wasting space on your server.
  110.  
  111.  
  112. 5) Graphical, Directory-based unix2dos, dos2unix, unix2mac, etc.
  113.  
  114. DOS/Windows, Macintosh, and UNIX all differ in their conventions for 
  115. line endings of ASCII text files.  As a result, files created on one 
  116. system and read on another may appear as one very long line, or with 
  117. garbage characters at the beginning or end of every line.  Most UNIX 
  118. systems have the dos2unix and unix2dos command line utilities to convert 
  119. files one at a time.  HTML Rename! provides a graphical user interface 
  120. to perform these operations on entire directories of files in one pass.
  121.  
  122.  
  123. SYSTEM REQUIREMENTS
  124. -------------------
  125.  
  126. HTML Rename! for Windows:
  127. 486/33MHz or greater processor
  128. 8MB RAM
  129. 5MB of free disk space
  130. Windows 95/95/NT/2000 (no NT 3.x)
  131.  
  132. HTML Rename! for Power Macintosh:
  133. Any PowerPC processor
  134. 8MB RAM
  135. 5MB of free disk space
  136. MacOS System 7 or greater (7.5 or greater recommended)
  137.  
  138.  
  139. INSTALLATION
  140. ------------
  141. No special installation is required.  Simply extract the files from the 
  142. archive and HTML Rename! will be ready for use.  
  143.  
  144. HTML Rename! is distributed either as a Windows zipped file 
  145. ("renawNNN.zip") or Macintosh Stuffit file ("renamNNN.sit"), where "NNN" 
  146. represents the version number.  If you have a self-extracting archive, 
  147. simply double click on it to extract the files.  Otherwise launch your 
  148. favorite application to unzip or unstuff the archive.  See below for 
  149. the list of files in the archive.
  150.  
  151.  
  152. PRICING OF HTML RENAME!
  153. -----------------------
  154. HTML Rename! is shareware.  As such, it is available for a free 30 day 
  155. evaluation period, after that the software will disable itself.  If you 
  156. find HTML Rename! useful you must register and pay a registration fee as 
  157. follows:
  158.  
  159. HTML Rename! 2.x for Windows 95/NT:  US$29  per user
  160. HTML Rename! 2.x for Macintosh:      US$29  per user
  161.  
  162. When your registration payment is received you will be sent a 
  163. registration key and be granted a license to have unlimited use of a 
  164. single copy of HTML Rename!.
  165.  
  166. A Site License costs US$750 (equal to 25 users) and covers all locations 
  167. for your organization within a 160 kilometer radius of your site (100 
  168. miles).  One big advantage of a Site License is that you do not need to 
  169. keep track of how many people at your site are using the software.  A 
  170. World-Wide License costs US$3000 and it covers all locations for your 
  171. organization on the planet earth.  Site and World-Wide Licenses for HTML 
  172. Rename! for Windows or HTML Rename! for Macintosh must be purchased 
  173. separately.
  174.  
  175.  
  176. HOW DO I REGISTER HTML RENAME!
  177. ------------------------------
  178. Registering HTML Rename! is fairly simple.  Click the "Register..." 
  179. button in the initial Shareware Notice dialog.  Then either click on 
  180. "Register online with a credit card..." to launch your browser and take 
  181. you to HTML Rename!'s online registration site, or click on "Register 
  182. via email, fax, or postal mail..." to launch the Register program.
  183.  
  184. Kagi handles payment processing for HTML Rename!, you will make your 
  185. payments out to them.  See more information about Kagi below.
  186.  
  187. NOTE: It is important that you provide YOUR EMAIL ADDRESS during 
  188. registration.  Expandable Language uses your email address to generate 
  189. the registration key which grants you unlimited use of a single copy of 
  190. HTML Rename!.  If you are ordering multiple copies or a Site or World-
  191. wide License, Expandable Language will contact you with information on 
  192. how to complete your registration.
  193.  
  194.  
  195. REGISTERING ONLINE
  196. ------------------
  197. Currently, only credit and debit card transactions and payment via First 
  198. Virtual can be handled online.  Click on "Register online with a credit 
  199. card..." from HTML Rename!'s registration dialog or point your browser 
  200. at "http://order.kagi.com/?NK&S" for a secure server or 
  201. "http://order.kagi.com/?NK" for a normal server.
  202. Enter your name, your email address, and the number of single user 
  203. licenses you desire for each program you wish to purchase (or Site or 
  204. Word-Wide licenses).  Click the "Submit" button to continue to the next 
  205. page and enter your credit card information for submission to Kagi.
  206.  
  207.  
  208. REGISTERING WITH THE REGISTER PROGRAM
  209. -------------------------------------
  210. Registration via the Register program allows payment by credit card, 
  211. check, cash, and some forms of digital payment and may be submitted via 
  212. email, fax, or "snail mail."  Enter your name, your email address, and 
  213. the number of single user licenses you desire for each program you wish 
  214. to purchase (or Site or Word-Wide licenses).  Save or Copy or Print the 
  215. data from the Register program and send the data and payment to Kagi.
  216.  
  217. If paying with Credit Card, you can email or fax the data to Kagi.  
  218. Their email address is sales@kagi.com and their fax number is 
  219. +1 510 652-6589.  You can either Copy the data from Register 
  220. and paste into the body of an email message or you can Save the data to 
  221. a file and you can attach that file to an email message.  There is no 
  222. need to compress the data file, it is already pretty small.  If you have 
  223. a fax modem, just Print the data to the Kagi fax number.
  224.  
  225. Payments sent via email are processed within 3 to 4 days.  You will 
  226. receive an email acknowledgment when it is processed.  Payments sent via 
  227. fax take up to 10 days and if you provide a correct Internet email 
  228. address you will receive an email acknowledgment.
  229.  
  230. If you are paying with Cash or USD Check you should print the data using 
  231. the Register application and send it to the address shown on the form, 
  232. which is:
  233.  
  234.           Kagi
  235.           1442-A Walnut Street, PMB 392-NK
  236.           Berkeley, California 94709-1405
  237.           USA
  238.  
  239. You can pay with a wide variety of cash from different countries but at 
  240. present if you pay via check, it must be a check drawn in US Dollars. 
  241. Kagi cannot accept checks in other currencies, the conversion rate for 
  242. non-USD checks is around USD 15 per check and that is just not 
  243. practical.  If you have a purchasing department, you can enter all the 
  244. data into the Register program and then select Invoice as your payment 
  245. method. Print three copies of the form and send it to your accounts 
  246. payable people. You might want to highlight the line that mentions that 
  247. they must include a copy of the form with their payment.
  248.  
  249. Kagi can not invoice your company, you need to act on our behalf and 
  250. generate the invoice and handle all the paperwork on your end.
  251.  
  252. Please do not fax or email payment forms that indicate Cash, Check or 
  253. Invoice as the payment method.  As far as we know, there is still no 
  254. technology to transfer physical objects via fax or email and without the 
  255. payment, the form cannot be processed.  Payments send via postal mail 
  256. take time to reach Kagi and then up to 10 days for processing.  Again, 
  257. if you include a correct email address, you will hear from Kagi when the 
  258. form is processed.
  259.  
  260.  
  261. WHAT IS THE CURRENT VERSION OF HTML RENAME!
  262. -------------------------------------------
  263. Check "http://www.xlanguage.com" to download the latest version.  
  264. If you are a registered user of HTML Rename!, you will receive email 
  265. notifying you of new releases.  Here is the current revision history:
  266.  
  267. HTML Rename! for Windows:
  268.   v1.00  27-Nov-96  Initial release
  269.   v1.10  10-Mar-97  Support for new tags, external text editor
  270.   v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  271.   v1.21  14-May-97  Fix relative URL substitution bug, base tags
  272.   v1.22  04-Mar-00  Fix CR/LF conversion bug, update address information
  273.   v2.00  31-Aug-00  Many new features: remove orphans, single-dialog interface
  274.  
  275. HTML Rename! for Macintosh:  
  276.   v1.00  27-Nov-96  Initial release
  277.   v1.10  10-Mar-97  Support for new tags, external text editor
  278.   v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  279.   v1.21  14-May-97  Fix relative URL substitution bug, base tags
  280.   v1.22  04-Mar-00  Fix CR/LF conversion bug, update address information
  281.   v2.00  31-Aug-00  Many new features: remove orphans, single-dialog interface
  282.  
  283. See the "History.txt" file for specific changes in each release.
  284.  
  285.  
  286. FILES IN THIS DISTRIBUTION
  287. --------------------------
  288. HTML Rename! for Windows 95/NT:
  289.   Readme-Rename.txt -- This file
  290.   HRename.exe       -- HTML Rename! for Windows executable program
  291.   Register.exe      -- Shareware registration program for HTML Rename!
  292.   Register.hlp      -- Windows Help file for Register.exe
  293.   License.txt       -- Software license agreement for this software
  294.   LocalReg.html     -- Points to online registration page
  295.   File_id.diz       -- Quick identifier with product and version info
  296.   History.txt       -- Version history for what is new in each version
  297.  
  298. HTML Rename! for Macintosh:
  299.   Readme-Rename.txt -- This file
  300.   HTML Rename!      -- HTML Rename! for Macintosh application
  301.   Register          -- Shareware registration app for HTML Rename!
  302.   License.txt       -- Software license agreement for this software
  303.   LocalReg.html     -- Points to online registration page
  304.   History.txt       -- Version history for what is new in each version
  305.  
  306.  
  307. WHO DEVELOPED HTML RENAME!
  308. --------------------------
  309. HTML Rename! was developed by Expandable Language, PMB 191,
  310. 2238B South Shore Center, Alameda, CA 94501 (info@xlanguage.com).
  311. Terence M. Parker (Terry) founded Expandable Language (formerly
  312. Parker & Associates) in 1994 after 10 years of experience in Berkeley 
  313. software companies.
  314.  
  315. Terry's roles in software startups have included Vice President of 
  316. Engineering at Vividata, Inc. and principal designer of Caere's OmniPage 
  317. optical character recognition product for UNIX/Motif.  His work has 
  318. included all aspects of software development and support, from initial 
  319. design through end-user support.  This experience is all brought to bear 
  320. on HTML Rename!.
  321.  
  322. HTML Rename! was born when Ken Milburn, one of the authors of 
  323. "Converting Content for Web Publishing" called Terry, saying that he had 
  324. not been able to find a much-needed utility to rename files.  Terry, who 
  325. has developed products for DOS, Windows, Macintosh, UNIX, etc., saw the 
  326. usefulness of such a utility and got a little carried away.  The result 
  327. (together with insights from the authors of Converting Content for Web 
  328. Publishing) is HTML Rename! -- a sophisticated, professional program 
  329. carefully designed and tested, and ready for serious work. 
  330.  
  331.  
  332. Last updated: 31-Aug-2000
  333. ###
  334.